Rename surface constructors
authorMatthias Clasen <mclasen@redhat.com>
Sun, 21 Apr 2019 16:51:10 +0000 (16:51 +0000)
committerMatthias Clasen <mclasen@redhat.com>
Tue, 28 May 2019 20:25:14 +0000 (20:25 +0000)
We want to use a gdk_surface_new_popup for popups,
and align the constructor names with the surface
types, so rename

gdk_surface_new_popup -> gdk_surface_new_temp
gdk_surface_new_popup_full -> gdk_surface_new_popup

The temp surface type will disappear eventually.

16 files changed:
docs/reference/gdk/gdk4-sections.txt
docs/reference/gtk/migrating-3to4.xml
gdk/broadway/gdksurface-broadway.c
gdk/gdksurface.c
gdk/gdksurface.h
gdk/wayland/gdkdrag-wayland.c
gdk/win32/gdkdevicemanager-win32.c
gdk/win32/gdkdrag-win32.c
gdk/x11/gdkdisplay-x11.c
gdk/x11/gdkdrag-x11.c
gdk/x11/gdksurface-x11.c
gtk/gtkmenu.c
gtk/gtkpopover.c
gtk/gtkwindow.c
testsuite/gtk/defaultvalue.c
testsuite/gtk/notify.c

index 38683fd47980e3bf9700ef15a0880640613db9c5..e3fa979d66bb1eee4eb2b26b972c9be518bb7f37 100644 (file)
@@ -179,8 +179,8 @@ GdkSurfaceEdge
 GdkSurfaceTypeHint
 GdkSurfaceState
 gdk_surface_new_toplevel
+gdk_surface_new_temp
 gdk_surface_new_popup
-gdk_surface_new_child
 gdk_surface_destroy
 gdk_surface_get_surface_type
 gdk_surface_get_display
index 381cdd00d0fb3d293b974aa42bd4e0d29301d148..87e29441edb91286cc5c7504e328dbeb29ff03d3 100644 (file)
       <para>
         The gdk_window_new() function has been replaced by a number of more
         specialized constructors: gdk_surface_new_toplevel(), gdk_surface_new_popup(),
-        gdk_surface_new_temp(), gdk_surface_new_child(), gdk_surface_new_input(),
-        gdk_wayland_surface_new_subsurface(). Use the appropriate ones to create
-        your windows.
+        gdk_surface_new_temp(), gdk_wayland_surface_new_subsurface().
+        Use the appropriate ones to create your windows.
       </para>
       <para>
         Native and foreign subwindows are no longer supported. These concepts were
index 980f4090a0437b99c0e5c71ac2be19054917a593..dcb6a9eb42487bbff641ed2951aea40cdcffc0c5 100644 (file)
@@ -1083,7 +1083,7 @@ create_moveresize_surface (MoveResizeData *mv_resize,
 
   g_assert (mv_resize->moveresize_emulation_surface == NULL);
 
-  mv_resize->moveresize_emulation_surface = gdk_surface_new_popup (mv_resize->display, &rect);
+  mv_resize->moveresize_emulation_surface = gdk_surface_new_temp (mv_resize->display, &rect);
 
   gdk_surface_show (mv_resize->moveresize_emulation_surface);
 
index c3dadf73ad6e537c63ca64cb2e8ad4baa1bb1f1e..a9ce2e834cc59edb9ce881954890568206a27706 100644 (file)
@@ -476,6 +476,7 @@ _gdk_surface_update_size (GdkSurface *surface)
 static GdkSurface *
 gdk_surface_new (GdkDisplay     *display,
                  GdkSurfaceType  surface_type,
+                 GdkSurface     *parent,
                  int             x,
                  int             y,
                  int             width,
@@ -500,7 +501,7 @@ gdk_surface_new (GdkDisplay     *display,
   gdk_surface_set_frame_clock (surface, frame_clock);
   g_object_unref (frame_clock);
 
-  gdk_display_create_surface_impl (display, surface, NULL);
+  gdk_display_create_surface_impl (display, surface, parent);
   surface->impl_surface = surface;
 
   g_signal_connect (display, "seat-removed", G_CALLBACK (seat_removed_cb), surface);
@@ -514,8 +515,7 @@ gdk_surface_new (GdkDisplay     *display,
  * @width: width of new surface
  * @height: height of new surface
  *
- * Creates a new toplevel surface. The surface will be managed by the surface
- * manager.
+ * Creates a new toplevel surface.
  *
  * Returns: (transfer full): the new #GdkSurface
  **/
@@ -526,33 +526,35 @@ gdk_surface_new_toplevel (GdkDisplay *display,
 {
   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
 
-  return gdk_surface_new (display, GDK_SURFACE_TOPLEVEL, 0, 0, width, height);
+  return gdk_surface_new (display, GDK_SURFACE_TOPLEVEL,
+                          NULL, 0, 0, width, height);
 }
 
 /**
- * gdk_surface_new_popup: (constructor)
+ * gdk_surface_new_temp: (constructor)
  * @display: the display to create the surface on
  * @position: position of the surface on screen
  *
- * Creates a new toplevel popup surface. The surface will bypass surface
- * management.
+ * Creates a new temporary surface.
+ * The surface will bypass surface management.
  *
  * Returns: (transfer full): the new #GdkSurface
  **/
 GdkSurface *
-gdk_surface_new_popup (GdkDisplay         *display,
-                       const GdkRectangle *position)
+gdk_surface_new_temp (GdkDisplay         *display,
+                      const GdkRectangle *position)
 {
   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
   g_return_val_if_fail (position != NULL, NULL);
 
   return gdk_surface_new (display, GDK_SURFACE_TEMP,
+                          NULL,
                           position->x, position->y,
                           position->width, position->height);
 }
 
 /**
- * gdk_surface_new_popup_full: (constructor)
+ * gdk_surface_new_popup: (constructor)
  * @display: the display to create the surface on
  * @parent: the parent surface to attach the surface to
  *
@@ -564,15 +566,17 @@ gdk_surface_new_popup (GdkDisplay         *display,
  * Returns: (transfer full): a new #GdkSurface
  */
 GdkSurface *
-gdk_surface_new_popup_full (GdkDisplay *display,
-                            GdkSurface *parent)
+gdk_surface_new_popup (GdkDisplay *display,
+                       GdkSurface *parent)
 {
   GdkSurface *surface;
 
   g_return_val_if_fail (GDK_IS_DISPLAY (display), NULL);
   g_return_val_if_fail (GDK_IS_SURFACE (parent), NULL);
 
-  surface = gdk_surface_new (display, GDK_SURFACE_TEMP, 0, 0, 100, 100);
+  surface = gdk_surface_new (display, GDK_SURFACE_TEMP,
+                             NULL, 0, 0, 100, 100);
+
   gdk_surface_set_transient_for (surface, parent);
   gdk_surface_set_type_hint (surface, GDK_SURFACE_TYPE_HINT_MENU);
 
index e1e0c53d0d89eb2dbd5aee3d4add570b53ca0372..03bc5f02f333e42f6a00d1b4f20a7b7b0581986f 100644 (file)
@@ -49,7 +49,7 @@ typedef struct _GdkGeometry          GdkGeometry;
 typedef enum
 {
   GDK_SURFACE_TOPLEVEL,
-  GDK_SURFACE_TEMP
+  GDK_SURFACE_TEMP,
 } GdkSurfaceType;
 
 /* Size restriction enumeration.
@@ -435,10 +435,10 @@ GdkSurface *   gdk_surface_new_toplevel         (GdkDisplay    *display,
                                                  int            width,
                                                  int            height);
 GDK_AVAILABLE_IN_ALL
-GdkSurface *   gdk_surface_new_popup            (GdkDisplay    *display,
+GdkSurface *   gdk_surface_new_temp             (GdkDisplay    *display,
                                                  const GdkRectangle *position);
 GDK_AVAILABLE_IN_ALL
-GdkSurface *   gdk_surface_new_popup_full       (GdkDisplay    *display,
+GdkSurface *   gdk_surface_new_popup            (GdkDisplay    *display,
                                                  GdkSurface    *parent);
 
 GDK_AVAILABLE_IN_ALL
index b163a17139cd9253a1c5d4eba6439cdb5857e9ac..6da90dca4962c136912d7c041682747a76dd7bbc 100644 (file)
@@ -208,7 +208,7 @@ create_dnd_surface (GdkDisplay *display)
 {
   GdkSurface *surface;
 
-  surface = gdk_surface_new_popup (display, &(GdkRectangle) { 0, 0, 100, 100 });
+  surface = gdk_surface_new_temp (display, &(GdkRectangle) { 0, 0, 100, 100 });
 
   gdk_surface_set_type_hint (surface, GDK_SURFACE_TYPE_HINT_DND);
   
index cc396f05639c9e9a5168d7f7c83ed4170c922776..85be7bf06b8e10a4d4af5a48aaf7bff7063bf9b7 100644 (file)
@@ -432,7 +432,7 @@ wintab_init_check (GdkDeviceManagerWin32 *device_manager)
                            ndevices, ncursors));
 #endif
   /* Create a dummy window to receive wintab events */
-  wintab_window = gdk_surface_new_popup (display, &(GdkRectangle) { -100, -100, 2, 2 });
+  wintab_window = gdk_surface_new_temp (display, &(GdkRectangle) { -100, -100, 2, 2 });
   g_object_ref (wintab_window);
 
   for (devix = 0; devix < ndevices; devix++)
index 9d486e15431fc8b85ddaf5c9e8cad35231f310f8..1e8ecf3474cee5695fae61ce82c5b95fde798f90 100644 (file)
@@ -1700,7 +1700,7 @@ create_drag_surface (GdkDisplay *display)
 {
   GdkSurface *surface;
 
-  surface = gdk_surface_new_popup (display, &(GdkRectangle) { 0, 0, 100, 100 });
+  surface = gdk_surface_new_temp (display, &(GdkRectangle) { 0, 0, 100, 100 });
 
   gdk_surface_set_type_hint (surface, GDK_SURFACE_TYPE_HINT_DND);
 
index 1ae6d1813bcd5fecc5d00141183ac7d2c6ec55f4..7d17dee28fdbba0af0ab51f9684409b01fb2d800 100644 (file)
@@ -1489,7 +1489,7 @@ gdk_x11_display_open (const gchar *display_name)
 
   {
     GdkRectangle rect = { -100, -100, 1, 1 };
-    display_x11->leader_gdk_surface = gdk_surface_new_popup (display, &rect);
+    display_x11->leader_gdk_surface = gdk_surface_new_temp (display, &rect);
   }
 
   (_gdk_x11_surface_get_toplevel (display_x11->leader_gdk_surface))->is_leader = TRUE;
index 5196b552ba50d2479d99882aa0f0a7dc39663e61..8c1e9869eabd879b92ba78f46ea0908efb8be9d3 100644 (file)
@@ -1324,7 +1324,7 @@ create_drag_surface (GdkDisplay *display)
 {
   GdkSurface *surface;
 
-  surface = gdk_surface_new_popup (display, &(GdkRectangle) { 0, 0, 100, 100 });
+  surface = gdk_surface_new_temp (display, &(GdkRectangle) { 0, 0, 100, 100 });
 
   gdk_surface_set_type_hint (surface, GDK_SURFACE_TYPE_HINT_DND);
   
@@ -2053,7 +2053,7 @@ _gdk_x11_surface_drag_begin (GdkSurface         *surface,
 
   display = gdk_surface_get_display (surface);
 
-  ipc_surface = gdk_surface_new_popup (display, &(GdkRectangle) { -99, -99, 1, 1 });
+  ipc_surface = gdk_surface_new_temp (display, &(GdkRectangle) { -99, -99, 1, 1 });
 
   drag = (GdkDrag *) g_object_new (GDK_TYPE_X11_DRAG,
                                    "surface", ipc_surface,
index 802d42dfab475792766d2d456da014b33709a177..11c9d97755a3561e723ad423a2a29c4df253ead2 100644 (file)
@@ -4108,7 +4108,7 @@ create_moveresize_surface (MoveResizeData *mv_resize,
 
   g_assert (mv_resize->moveresize_emulation_surface == NULL);
 
-  mv_resize->moveresize_emulation_surface = gdk_surface_new_popup (mv_resize->display, &rect);
+  mv_resize->moveresize_emulation_surface = gdk_surface_new_temp (mv_resize->display, &rect);
   gdk_surface_show (mv_resize->moveresize_emulation_surface);
 
   status = gdk_seat_grab (gdk_device_get_seat (mv_resize->device),
index 4aca9c31ecf730539ddb067dafda5adf9dc6d2bf..c856ae546c8dd11f32f8a1ec3c6be31c9c522678 100644 (file)
@@ -2200,7 +2200,7 @@ menu_grab_transfer_surface_get (GtkMenu *menu)
   if (!surface)
     {
       GdkRectangle rect = { -100, -100, 1, 1 };
-      surface = gdk_surface_new_popup (gtk_widget_get_display (GTK_WIDGET (menu)), &rect);
+      surface = gdk_surface_new_temp (gtk_widget_get_display (GTK_WIDGET (menu)), &rect);
 
       gdk_surface_show (surface);
 
index 8b70335fdbaf470e4b444e3e27c2204affab945f..90457cbed57ddede7b0ee0e586c3997649593b6a 100644 (file)
@@ -479,7 +479,7 @@ gtk_popover_realize (GtkWidget *widget)
 
   display = gtk_widget_get_display (priv->relative_to);
 
-  priv->surface = gdk_surface_new_popup_full (display, gtk_widget_get_surface (priv->relative_to));
+  priv->surface = gdk_surface_new_popup (display, gtk_widget_get_surface (priv->relative_to));
 
   gtk_widget_set_surface (widget, priv->surface);
   gdk_surface_set_widget (priv->surface, widget);
index 5ce9d70c5c895679e018b1e7100b5c3f1bb5afe2..ca8d34e05385da5f39b1d97dca4a1430503c88e5 100644 (file)
@@ -5690,7 +5690,7 @@ gtk_window_realize (GtkWidget *widget)
                                              allocation.height);
           break;
         case GTK_WINDOW_POPUP:
-          surface = gdk_surface_new_popup (gtk_widget_get_display (widget), &allocation);
+          surface = gdk_surface_new_temp (gtk_widget_get_display (widget), &allocation);
           break;
         default:
           g_error (G_STRLOC": Unknown window type %d!", priv->type);
index ae7849f1c7386616018d274a46b62ddd56e47395..1ac3bdfe97961b6bda7ad07e8610b267b11e087e 100644 (file)
@@ -106,7 +106,7 @@ test_type (gconstpointer data)
     instance = G_OBJECT (g_object_ref (gtk_settings_get_default ()));
   else if (g_type_is_a (type, GDK_TYPE_SURFACE))
     {
-      instance = G_OBJECT (g_object_ref (gdk_surface_new_popup (display,
+      instance = G_OBJECT (g_object_ref (gdk_surface_new_temp (display,
                                                                 &(GdkRectangle) { 0, 0, 100, 100 })));
     }
   else if (g_type_is_a (type, GTK_TYPE_FILTER_LIST_MODEL))
index e1622059da08a696463e1822288967a7e9a0bcb4..40c16cb746b3f17a89ddb923370529971341c17a 100644 (file)
@@ -406,7 +406,7 @@ test_type (gconstpointer data)
     instance = G_OBJECT (g_object_ref (gtk_settings_get_default ()));
   else if (g_type_is_a (type, GDK_TYPE_SURFACE))
     {
-      instance = G_OBJECT (g_object_ref (gdk_surface_new_popup (display,
+      instance = G_OBJECT (g_object_ref (gdk_surface_new_temp (display,
                                                                &(GdkRectangle) { 0, 0, 100, 100 })));
     }
   else if (g_str_equal (g_type_name (type), "GdkX11Cursor"))